Condividi tramite


Manage orders - Gets a product promotion by id.

Ottiene i dettagli della promozione in base all'ID.

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
id
path True

string

ID promozione.

version
path True

string

country
query

string

Codice paese.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Authorization True

string

Token di connessione dell'autorizzazione

ms-correlationid

string

Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo elemento per ogni richiesta

MS-CV

string

Usato per tenere traccia delle richieste internamente. Se non viene specificata una MS-CV, il server genererà un nuovo per ogni richiesta

ms-requestid

string

Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà un nuovo per ogni richiesta

Risposte

Nome Tipo Descrizione
200 OK

Contracts.V1.Models.ProductPromotion

La richiesta ha avuto esito positivo. Il corpo della risposta conterrà i dettagli della promozione.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

La risorsa non viene trovata o non è disponibile con i parametri di input specificati.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definizioni

Nome Descrizione
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotion

Nome Tipo Descrizione
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

Nome Tipo Descrizione
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

Nome Tipo Descrizione
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

Nome Tipo Descrizione
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

Nome Tipo Descrizione
billingCycle

string

duration

string